home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 5 / Amiga Plus Sonderheft 1996 #5.iso / sonstiges / superviewel / superviewlibrary / docs / controlpads next >
Text File  |  1986-04-04  |  19KB  |  304 lines
  1.  
  2.   ControlPad-FAQ V13.1 (24.3.96)
  3.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5.   List has been sorted alphabetically and by module types
  6.   (information has been derived from docs basing on CPInfo-Files).
  7.  
  8.   ============================================================================
  9.   MAIN LIBRARIES
  10.   ----------------------------------------------------------------------------
  11.   ControlPad-Name     : "ENV:superview-library/LIBRARY.controlpad"
  12.   ControlPad-Commands : - DEFAULTSVDRIVER=<#?.svdriver>
  13.                           ; Which SVDriver should be set, when
  14.                           ; superview-library is beeing initialized ?
  15.                           ; For example: "DEFAULTSVDRIVER=AGA.svdriver"
  16.                         - ANYDATATYPES
  17.                           ; if this KeyWord is set, ANY DataTypes will
  18.                           ; be loaded and tried to be displayed in some
  19.                           ; way (e.g. not only pictures, but also 8SVX
  20.                           ; sounds or ANIM-Files ...)
  21.                           ; This changes are recognized each time, when
  22.                           ; a new handle for loading a file is being
  23.                           ; initialized - but may be superseded by specific
  24.                           ; program's settings internally.
  25.   ----------------------------------------------------------------------------
  26.   ControlPad-Name     : "ENV:superview-library/superviewsupport.controlpad"
  27.   ControlPad-Commands : - C2P=<OS|SV>
  28.                           ; determines, whether chunky to planar conversion
  29.                           ; is managed via the appropriate OS functions
  30.                           ; or via internal ones.
  31.                           ; Due to various problems with the OS functions
  32.                           ; "SV" is now default.
  33.                           ; Be careful when using "OS" with GfxCards,
  34.                           ; which carelessly patched graphics.library.
  35.   ============================================================================
  36.   SVOBJECTS
  37.   ----------------------------------------------------------------------------
  38.   ControlPad-Name     : "ENV:superview-library/FastILBM24.controlpad"
  39.   ControlPad-Commands : - BUFFERSIZE=<Size in Bytes>
  40.                           ; how many bytes should be buffered
  41.                             (more = faster)
  42.                           ; Default is 8192, minimum is 256
  43.                         - PASSTHROUGH
  44.                           ; do not recognize ANY pictures, so that
  45.                           ; they e.g. might be passed through to
  46.                           ; ILBM.svobject instead
  47.                         - DITHERMODE=<HAM6_QUICK|HAM8_QUICK>
  48.                           ; Default is HAM6_QUICK
  49.   ----------------------------------------------------------------------------
  50.   ControlPad-Name     : "ENV:superview-library/JPEG.controlpad"
  51.   ControlPad-Commands : - COLORDEPTH=<8|24>
  52.                           ; For READING colored 24 Bit images:
  53.                           ; should the output be done as 8 or 24 Bit Data ?
  54.                           ; default is 8 Bit data. Grayscaled graphics
  55.                           ; will _always_ be exported as 8 Bit
  56.                         - FORCE_GRAY_DECODE
  57.                           ; For READING images:
  58.                           ; this switch overrides the selected depth
  59.                           ; for colored images and always exports them
  60.                           ; as 8 Bit grayscaled pictures
  61.                           ; default is: not set
  62.                         - DECODE_METHOD=<FAST_INTEGER|SLOW_INTEGER|
  63.                                          FLOATING_POINT|FASTEST_INTEGER>
  64.                           ; For READING images:
  65.                           ; how to DECODE the 24 Bit or gray data
  66.                           ; default is: FAST_INTEGER
  67.                         - DITHERMODE=<DITHER_FLOYD-STEINBERG|
  68.                                       NO_DITHERING|DITHER_ORDERED>
  69.                           ; For READING and dithering 24 Bit images
  70.                           ; to 8 Bit images:
  71.                           ; how and whether to DITHER the 24 Bit data
  72.                           ; default is: DITHER_FLOYD-STEINBERG
  73.                         - COLOR_QUANTIZING=<FAST|SLOW>
  74.                           ; For READING and dithering 24 Bit images
  75.                           ; to 8 Bit images:
  76.                           ; whether to QUANTIZE the 24 Bit data within
  77.                           ; two passes
  78.                           ; default is: SLOW
  79.                         - UPSAMPLING=<ON|OFF>
  80.                           ; For READING and dithering 24 Bit images
  81.                           ; to 8 Bit images:
  82.                           ; whether to do fancy upsampling on the 24 Bit
  83.                           ; default is: ON
  84.                         - QUANTIZATION=<0..100>
  85.                           ; For WRITING 8/24 Bit images as 24 Bit JPEG:
  86.                           ; 0   - poor quality, big compression
  87.                           ; 100 - best quality, no compression
  88.                           ; never use such extreme values, but try
  89.                           ; something like 20, 50, 75
  90.                           ; default is: 75)
  91.                         - FORCE_GRAY_ENCODE
  92.                           ; For WRITING images:
  93.                           ; this switch causes grayscales to be written
  94.                           ; no matter, whether the input was colored
  95.                           ; default is: not set
  96.                         - ENCODE_METHOD=<FAST_INTEGER|SLOW_INTEGER|
  97.                                          FLOATING_POINT|FASTEST_INTEGER>
  98.                           ; For WRITING images:
  99.                           ; how to ENCODE the 24 Bit or gray data
  100.                           ; default is: FAST_INTEGER
  101.                         - OPTIMIZE=<ON|OFF>
  102.                           ; For WRITING 24 Bit images:
  103.                           ; whether to optimize the generated huffman
  104.                           ; code (good compression, but slow)
  105.                           ; default is: OFF
  106.                         - PROGRESSIVE=<ON|OFF>
  107.                           ; For WRITING 24 Bit images:
  108.                           ; whether to write progressive JPEG files
  109.                           ; default is: OFF
  110.   ----------------------------------------------------------------------------
  111.   ControlPad-Name     : "ENV:superview-library/PCD.controlpad"
  112.   ControlPad-Commands : - OUTPUTFORMAT=<BASE/16 | BASE/4 | BASE >
  113.                           ; specifies the output resolution to be used
  114.   ----------------------------------------------------------------------------
  115.   ControlPad-Name     : "ENV:superview-library/SVG.controlpad"
  116.   ControlPad-Commands : - PACKMETHOD=<xxxx>
  117.                           ; if this one is specified, it is tried to
  118.                           ; pack the resulting file with the specified
  119.                           ; XPK-Packer. If this fails, the file keeps
  120.                           ; unpacked.
  121.   ============================================================================
  122.   SVDRIVERS
  123.   ----------------------------------------------------------------------------
  124.   ControlPad-Name     : "ENV:superview-library/AGA.controlpad"
  125.   ControlPad-Commands : - 24BITOPERATOR=<OperatorName>
  126.                           ; (case-sensitive, ".svoperator" may be added)
  127.                           ; e.g. "24BITOPERATOR=24BitToHAM.svoperator"
  128.                           ; or   "24BITOPERATOR=ExtractGrayScales"
  129.                           ; specifies, which operation should be performed
  130.                           ; on 24 Bit graphics _before_ displaying them
  131.                           ; (if not specified, "best guess" colors will
  132.                           ;  be used, which is really slow)
  133.                         - BITMAPCOPY=<DIRECT|RTG>
  134.                           ; "BITMAPCOPY=RTG" prevents AGA.svdriver from
  135.                           ; directly copying into Bitmaps, which will
  136.                           ; result in a usage of more memory, but keeps it
  137.                           ; working.
  138.                           ; Default is "BITMAPCOPY=DIRECT".
  139.                         - SCREENINFRONT
  140.                           ; Put Screen to front _before_ the graphics
  141.                           ; has been displayed (useful with GfxCards)
  142.   ----------------------------------------------------------------------------
  143.   ControlPad-Name     : "ENV:superview-library/ECS.controlpad"
  144.   ControlPad-Commands : - 24BITOPERATOR=<OperatorName>
  145.                           ; (case-sensitive, ".svoperator" may be added)
  146.                           ; e.g. "24BITOPERATOR=24BitToHAM.svoperator"
  147.                           ; or   "24BITOPERATOR=ExtractGrayScales"
  148.                           ; specifies, which operation should be performed
  149.                           ; on 24 Bit graphics _before_ displaying them
  150.                           ; (if not specified displaying will fail)
  151.                         - 8BITOPERATOR=<OperatorName>
  152.                           ; (case-sensitive, ".svoperator" may be added)
  153.                           ; e.g. "8BITOPERATOR=ExtractGrayScales"
  154.                           ; specifies, which operation should be performed
  155.                           ; on non-ECS graphics (more than 16 Colors in
  156.                           ; HighRes, more than 32 Colors in LowRes, HAM8)
  157.                           ; (if not specified, will be tried to display)
  158.                         - BITMAPCOPY=<DIRECT|RTG>
  159.                           ; "BITMAPCOPY=RTG" prevents ECS.svdriver from
  160.                           ; directly copying into Bitmaps, which will
  161.                           ; result in a usage of more memory, but keeps it
  162.                           ; working.
  163.                           ; Default is "BITMAPCOPY=DIRECT".
  164.                         - SCREENINFRONT
  165.                           ; Put Screen to front _before_ the graphics
  166.                           ; has been displayed (useful with GfxCards)
  167.   ----------------------------------------------------------------------------
  168.   ControlPad-Name     : "ENV:superview-library/CyberGraphics.controlpad"
  169.   ControlPad-Commands : - EMUSCREENDEPTH=<16|24>
  170.                           ; beginning depth for opening CyberGraphics Screens
  171.                           ; Default is 16 Bit (which will also be tried
  172.                           ; when opening of a 24 Bit Screen fails)
  173.                           ; This does not concern colordepths < 16 Bit,
  174.                           ; except HAM6/8.
  175.                         - SMALLSCREENS
  176.                           ; unless this KeyWord is specified, it is not
  177.                           ; tried to open screens smaller than 320x240
  178.   ----------------------------------------------------------------------------
  179.   ControlPad-Name     : "ENV:superview-library/PicassoII.controlpad"
  180.   ControlPad-Commands : - SMALLSCREENS
  181.                           ; unless this KeyWord is specified, it is not
  182.                           ; tried to open screens smaller than 320x240
  183.                         - BLITTER
  184.                           ; uses the Picasso blitter to copy graphics
  185.                           ; into screens. Otherwise CPU is used.
  186.                           ; On 68000 systems you may wish to use the blitter
  187.                         - EMUSCREENDEPTH=<16|24>
  188.                           ; beginning depth for opening Picasso Screens
  189.                           ; Default is 24 Bit (if opening fails, it is
  190.                           ; also tried to open a 16 Bit Screen, then)
  191.                         - SCREENMODEREQUEST
  192.                           ; if this one is specified, the SVDriver ITSELF
  193.                           ; will open a ScreenMode-Requester and ask
  194.                           ; for an appropriate Screenmode to use
  195.                           ; Useful, if you always like to change modes.
  196.                         - AUTOSCROLLADJUST
  197.                           ; this keyword will force Autoscroll whenever
  198.                           ; it would make sense, but the Picasso Software
  199.                           ; would not manage it by itself (when either
  200.                           ; only width or height need to be autoscrolled)
  201.   ----------------------------------------------------------------------------
  202.   ControlPad-Name     : "ENV:superview-library/Retina.controlpad"
  203.   ControlPad-Commands : - EMUSCREENDEPTH=<16|24>
  204.                           ; beginning depth for opening Retina Screens
  205.                           ; Default is 24 Bit (if opening fails, it is
  206.                           ; also tried to open a 16 Bit Screen, then)
  207.   ============================================================================
  208.   SVOPERATORS
  209.   ----------------------------------------------------------------------------
  210.   ControlPad-Name     : "ENV:superview-library/24BitToHAM.controlpad"
  211.   ControlPad-Commands : - DITHERMODE=< HAM6_QUICK|HAM6_WELL
  212.                                       |HAM8_QUICK|HAM8_WELL>
  213.                           ; specifies the HAM-Mode to be used and
  214.                           ; the resulting speed/quality
  215.   ----------------------------------------------------------------------------
  216.   ControlPad-Name     : "ENV:superview-library/CallPNM24.controlpad"
  217.   ControlPad-Commands : - PNMCOMMAND=<PBM command path and name>
  218.                           ; PNM command to be called
  219.                           ; e.g. PNMCOMMAND=Work:NetPBM/pnm/pnmscale
  220.                         - PNMOPTIONS=<Options>
  221.                           ; Options for PNM command to be called
  222.                           ; e.g. PNMOPTIONS=-xscale 2.0 -yscale 2.0
  223.   ----------------------------------------------------------------------------
  224.   ControlPad-Name     : "ENV:superview-library/Crop.controlpad"
  225.   ControlPad-Commands : - CROP_LEFTEDGE=<Value>
  226.                           ; crop from x position
  227.                           ; (will be adjusted, if >= source width)
  228.                         - CROP_TOPEDGE=<Value>
  229.                           ; crop from y position
  230.                           ; (will be adjusted, if >= source height)
  231.                         - CROP_WIDTH=<Value>
  232.                           ; crop how many x pixels from leftedge
  233.                           ; (will be adjusted, if too large)
  234.                         - CROP_HEIGHT=<Value>
  235.                           ; crop how many y pixels from topedge
  236.                           ; (will be adjusted, if too large)
  237.   ----------------------------------------------------------------------------
  238.   ControlPad-Name     : "ENV:superview-library/Dither24Bit.controlpad"
  239.   ControlPad-Commands : - COLORDEPTH=<1..8>
  240.                           ; specifies the colordepth of the dithering
  241.                           ; output (1->2 Colors .. 8->256 Colors)
  242.   ----------------------------------------------------------------------------
  243.   ControlPad-Name     : "ENV:superview-library/ExtractGrayScales.controlpad"
  244.   ControlPad-Commands : - COLORDEPTH=<1..8>
  245.                           ; specifies the colordepth of the grayscaled
  246.                           ; output (1->2 Colors .. 8->256 Colors)
  247.                         - QUICK
  248.                           ; uses >>2, >>1, >>3 (*0.25, *0.5, *0.125)
  249.                           ; instead of *0.3, *0.59, *0.11
  250.   ----------------------------------------------------------------------------
  251.   ControlPad-Name     : "ENV:superview-library/HilbertDither256.controlpad"
  252.   ControlPad-Commands : - BACKGROUND=<BLACK|WHITE>
  253.                           ; defines, which of the two colors will act
  254.                           ; as background color. Useful e.g. for printing.
  255.   ----------------------------------------------------------------------------
  256.   ControlPad-Name     : "ENV:superview-library/PaletteDither.controlpad"
  257.   ControlPad-Commands : - COLORDEPTH=<1..8>
  258.                           ; specifies the colordepth of the final,
  259.                           ; dithered graphics (1..8 for 2..256 colors)
  260.                         - PALETTEDEPTH=<1..8>
  261.                           ; number of colors (depth) to be taken from the
  262.                           ; fixed palette - the possible rest will be
  263.                           ; generated (if specifying more palette colors
  264.                           ; than available, all available will be taken)
  265.                         - PALETTEFILE=<palette graphics filename>
  266.                           ; any 2..256 color graphics file, of which
  267.                           ; superview.library is able to extract a
  268.                           ; palette from (for example an IFF-ILBM file,
  269.                           ; but including a BMHD and - maybe empty - BODY).
  270.                           ; Allows to take one graphics as sample for
  271.                           ; the others (concerning the palette).
  272.   ----------------------------------------------------------------------------
  273.   ControlPad-Name     : "ENV:superview-library/Rotate.controlpad"
  274.   ControlPad-Commands : - DEGREES=<90|180|270>
  275.                           ; rotate by how many degrees (reverse clockwise) ?
  276.   ----------------------------------------------------------------------------
  277.   ControlPad-Name     : "ENV:superview-library/RotateFree.controlpad"
  278.   ControlPad-Commands : - ROTATE_ANGLE=<0..360>
  279.                           ; rotate by how many degrees (reverse clockwise) ?
  280.                         - METHOD=<MIDDLE|GIVENPOINT>
  281.                           ; default is rotation about the middle
  282.                         - X_COORD=<Value>
  283.                           ; if METHOD=GIVENPOINT we need (X/Y)
  284.                           ; Default is (0/0)
  285.                         - Y_COORD=<Value>
  286.                           ; if METHOD=GIVENPOINT we need (X/Y)
  287.                           ; Default is (0/0)
  288.                         - KEEPSIZE
  289.                           ; if this keyword is set, it is NOT tried to
  290.                           ; readjust the image size and to center the
  291.                           ; image, so that parts, which would be out of
  292.                           ; range won't be cut off (which works best
  293.                           ; with (X/Y) pairs in the left, upper quarter)
  294.   ----------------------------------------------------------------------------
  295.   ControlPad-Name     : "ENV:superview-library/Scale50.controlpad"
  296.   ControlPad-Commands : - METHOD=<HALF|DOUBLE>
  297.                           ; scale to which size ?
  298.   ----------------------------------------------------------------------------
  299.   ControlPad-Name     : "ENV:superview-library/XOR.controlpad"
  300.   ControlPad-Commands : - XORVALUE = <0..255>
  301.                           ; 0 and 255 will not be the best decision.
  302.                           ; Use 15 or something like this.
  303.   ----------------------------------------------------------------------------
  304.